home *** CD-ROM | disk | FTP | other *** search
/ Precision Software Appli…tions Silver Collection 3 / Precision Software Applications Silver Collection Volume Three (PSM) (1993).iso / music2 / smileq20.exe / SMILEQ20.DOC < prev    next >
Text File  |  1992-06-12  |  16KB  |  422 lines
  1.  
  2.           Your SMILEQ20 file should contain the following files:
  3.  
  4.           SMILEQ.EXE    -   SMILE Quick viewer.
  5.           SMILEL.EXE    -   SMILE List viewer.
  6.           SMILESS.EXE   -   SMILE Slide Show.
  7.  
  8.           SMILEQ20.DOC contains documentation for all programs.
  9.           Please DO NOT distribute these programs separately.
  10.  
  11.           These ANSI display utilities allow the user to view
  12.           files containing ANSI sequences, Music strings (in BASIC
  13.           "PLAY" format), and Sounds (using a custom SOUND code).
  14.      
  15.           NO ANSI DRIVER is required to view ANSI screens as all
  16.           programs contain a built-in ANSI translator.  Keyboard
  17.           reassignment codes are ignored.
  18.  
  19.  
  20.  
  21.  
  22.  
  23.          ┌──┐
  24.          │SMILE Quick  Ver 2.0   Copyright (c) 1991.....Michael Arnett
  25.          └──┘ 
  26.      
  27.           Syntax:
  28.  
  29.           SMILEQ file1 [file2]... [/B][/C][/F][/M][/N#][/S#][/T#]
  30.  
  31.           Enter SMILEQ at the DOS prompt to view a list of available
  32.           parameters.
  33.      
  34.           SMILEQ displays files specified on the command line using
  35.           (optional) /switch features.  SMILEQ will default to an ANS
  36.           extension if none is given.  Wild cards are supported in
  37.           filespec designations.  
  38.             
  39.           See list of COMMAND LINE SWITCHES for definitions.
  40.      
  41.  
  42.  
  43.  
  44.  
  45.          ┌──┐
  46.          │SMILE List  Ver 1.0   Copyright (c) 1992.....Michael Arnett
  47.          └──┘ 
  48.  
  49.           Syntax:
  50.  
  51.           SMILEL  [/B][/C][/F][/M][/S#][/T#]
  52.  
  53.           A scrolling pick list of *.ANS files is presented for
  54.           display.  Available memory determines the number of files
  55.           that can be listed.  600 files were listed, in a test, with
  56.           about 580K of free memory.  Other options available from
  57.           this list include:
  58.  
  59.                Changing Drives, Directories and File mask. 
  60.                Sorting list on Name, Extension, Size, etc.
  61.                Expand Directory window to show file information.
  62.  
  63.            Scroll through the list using the Cursor Keys, PgUp, PgDN,
  64.            Home, End kyes, or mouse.  Highlight the file you want to
  65.            view and press ENTER or CLICK the Left Mouse button.  Press
  66.            ESC or Right Mouse button to Exit.
  67.  
  68.            See list of COMMAND LINE SWITCHES for definitions.
  69.  
  70.  
  71.  
  72.  
  73.  
  74.          ┌──┐
  75.          │SMILE Slide Show   Ver 1.0   Copyright (c) 1992...Michael Arnett
  76.          └──┘ 
  77.  
  78.           Syntax:
  79.             
  80.           SMIELSS  Filespec [/B][/C][/M][/N#][/S#][/T#]
  81.  
  82.           SMILE Slide Show reads file names for display from a specified
  83.           file (Filespec).  Display of files will cycle until CANCLED.  
  84.  
  85.           SMILEQ List.dat
  86.               
  87.           would instruct SMILESS to read file names from the file
  88.           LIST.DAT.  The format for LIST.DAT is as follows:
  89.             
  90.              file1.ans [ switches ] 
  91.              file2.ans [ switches ] 
  92.              file3.ans [ switches ] 
  93.              etc...
  94.             
  95.           FILELST.DAT files, built by "The SMILE Viewer", can be
  96.           used with SMILE SLIDE SHOW.  
  97.  
  98.           Command line options listed above may be designated on the 
  99.           command line for GLOBAL, use or a unique set of options may
  100.           be chosen for each file name specified.  For example:
  101.  
  102.                SMILEQ List.dat      { All options set to default   }
  103.  
  104.                file1.ans  /C        { view in EGA/VAG mode         }
  105.                file2.ans            { default options reset        }
  106.                file3.ans  /S2400    { Simulate 2400B rate display  }
  107.                file4.ans            { default options reset        }
  108.  
  109.  
  110.           Wildcards are *NOT* supported withSMILE Slide Show.
  111.             
  112.           See list of COMMAND LINE SWITCHES for definitions.     
  113.      
  114.  
  115.  
  116.  
  117.  
  118.          ┌──┐
  119.          │COMMAND LINE SWITCHES (optional)
  120.          └──┘ 
  121.      
  122.           /B ... Disable screen Blanking (clearing) before each
  123.                  file is displayed.  
  124.  
  125.               [*]SUPPORTED in SMILEQ, SMILEL, and SMILESS     
  126.               [*]DEFAULT: clear screen before each file is displayed
  127.           
  128.           /C ... Toggles EGA/VGA monitors between 25 Line TEXT mode
  129.                  and 43/50 Line TEXT mode.  Screen is returned to 
  130.                  START-UP mode when you exit SMILEQ.  If you're PC is in 
  131.                  43/50 Line mode and you start SMILEQ with this switch, 
  132.                  25 Line mode will be toggled on.
  133.  
  134.               [*]SUPPORTED in SMILEQ, SMILEL, and SMILESS     
  135.               [*]DEFAULT: Start-up mode
  136.             
  137.           /F ... Delete/Rename file after viewing.  An option box
  138.                  is popped up after the screen is displayed.
  139.  
  140.               [*]SUPPORTED in SMILEQ and SMILEL          
  141.               [*]DEFAULT: File Rename/Delete option is OFF
  142.  
  143.           /M ... Disable Music and SOUND codes.
  144.        
  145.               [*]SUPPORTED in SMILEQ, SMILEL, and SMILESS
  146.               [*]DEFAULT: Music ON
  147.            
  148.           /N#... Nonstop display between screens.  # specifies the
  149.                  number of seconds to delay. (0..60) Nonstop delay 
  150.                  defaults to 3 seconds if no number is specified.
  151.              
  152.               [*]SUPPORTED in SMILEQ and SMILESS
  153.               [*]DEFAULT: Prompt for keypress between each screen
  154.             
  155.           /S#... Set Simulated BAUD rate display speed.  # specifies 
  156.                  desired BAUD rate.  Valid speeds are 19200, 9600,
  157.                  2400 1200, and 300.  If no rate, or an invalid rate 
  158.                  is specified, Speed defaults to 2400.
  159.             
  160.               [*]SUPPORTED in SMILEQ, SMILEL, and SMILESS
  161.               [*]DEFAULT: 0 (Fastest display)
  162.      
  163.           /T#... Define an ESC translate character.  "#" desigantes
  164.                  the Decimal value of a character.  Some BBS software
  165.                  strips all ESC characters from ANSI screens.  This 
  166.                  switch allows you to specify what that character 
  167.                  will be.  SMILEQ will translate any combination of 
  168.                  the character and "[" to a true ESC.  Valid entries
  169.                  are 1 to 254.
  170.                  (DEC 96 and DEC 250  are translated automatically)
  171.  
  172.               [*]SUPPORTED in SMILEQ, SMILEL, and SMILESS
  173.               [*]DEFAULT: none
  174.  
  175.  
  176.  
  177.  
  178.  
  179.          ┌──┐
  180.          │VIEWING FILES:
  181.          └──┘ 
  182.      
  183.           The SMILE viewers now have support for unlimited characters
  184.           per line.  Multiple lines of MUSIC may be entered between
  185.           ESC[ and CTRL-N.  There is no limit on actual file size.  
  186.      
  187.           DEFAULT MODE: 
  188.  
  189.           Pressing ESC will CANCEL the display and/or stop the
  190.           program.  Any other key will PAUSE the display and a 
  191.           "More (Y/n)" prompt will be displayed.
  192.      
  193.           NONSTOP MODE: 
  194.  
  195.           Pressing ESC during screen display will CANCEL the display
  196.           and stop the program.  Any other key will PAUSE for
  197.           specified number of DELAY seconds.  Pressing ESC during the
  198.           PAUSE counter will stop the counter and display the next 
  199.           screen.
  200.  
  201.      
  202.           To try and support users where local Bulletin Boards
  203.           convert ESC characters, SMILEQ will translate the following
  204.           as ESC sequences:
  205.      
  206.           ·[   ( Dec 250 + [ ) 
  207.           ∙[   ( Dec 249 + [
  208.           `[   ( Dec 96 + [ )
  209.  
  210.           The /T# switch may also be used to define a custom ESC 
  211.           translate character.
  212.  
  213.           Screens should display if multiple codes are used in a file
  214.           but this should probaby be avoided.
  215.           
  216.           
  217.           Since old habits die hard, support for the GT Power BBS
  218.           message base "pause character" continues to be supported.
  219.           The CTRL-E character (Dec 5) placed as the first character
  220.           of a line will cause SMILEQ to pause as described in the
  221.           DEFAULT and NONSTOP modes above.
  222.      
  223.      
  224.      
  225.      
  226.  
  227.          ┌──┐
  228.          │MUSIC:
  229.          └──┘ 
  230.  
  231.           Syntax: ESC[MF T120 O2C8D8E8F8G8 (CTRL-N)
  232.      
  233.           Music strings in the BASIC Play format are supported.
  234.           Multiple strings per line may be entered.  
  235.      
  236.           Music strings should begin with the characters "<esc>[M"
  237.           where <esc> is a true ESC character (DEC 27, Hex 1B).
  238.           Please refer to your BASIC manual for information on the
  239.           BASIC Play commands.  The following are all valid for
  240.           beginning a Music string in SMILEQ: MF, MB, MN, ML, MS, M .
  241.           Although MB (Music Background) is valid, true backgroud    
  242.           music is NOT supported.
  243.      
  244.           Music strings should end with the musical note character
  245.           CTRL-N (DEC 14, Hex 0E).  If this character is missing,
  246.           SMILEQ will look for the next ESC character or the
  247.           end-of-file marker to terminate the music string.  This
  248.           option was added to try and catch as many incorrectly
  249.           formated music strings as possible.  However, for
  250.           compatiblity with other viewers, I suggest you always end
  251.           your music strings with CTRL-N (DEC 14)
  252.      
  253.  
  254.      
  255.          ┌──┐
  256.          │SOUND:
  257.          └──┘ 
  258.           [*]Thanks to Julie Ibarra, author of ANSIPLAY for this idea
  259.      
  260.           Syntax: 
  261.           Freq; Duration; Cycle1; Delay1; Variation; Cycle2; Delay2
  262.      
  263.           Custom Sounds are supported in SMILEQ by using a SOUND CODE
  264.           similar to that found in BASIC, but emulates the custom
  265.           SOUND CODE found in the program ANSIPLAY more closely.
  266.           However, a second Cycle\Delay option was added to the SOUND 
  267.           CODE used in SMILEQ, providing a looping effect.  The frequency
  268.           values used to produce the musical notes are listed somewhere
  269.           down the page.  Duration timing was also adjusted in SMILEQ
  270.           to more closely match that of the BASIC SOUND command.  The
  271.           Duration of SOUNDs created for earlier versions of SMILEQ will 
  272.           have to be edited.     
  273.  
  274.           The SOUND statement must begin and end in the same manner
  275.           discussed above for a normal music string.  
  276.  
  277.           The SOUND CODE consists of the following parameters serparated 
  278.           by a semicolons (;) :
  279.      
  280.           FREQ     : Frequency of note to be played.  The effective 
  281.                      range of frequencies is 37 to 7904.  
  282.                      (0..65535)
  283.           
  284.           DURATION : Time, in CLOCK TICKS, the note should be played.
  285.                      (18.2 ticks per second)
  286.                      (0..65535)
  287.              
  288.           CYCLE1   : Number of times to repeat Frequency\Duration.
  289.                      (0..65535)
  290.              
  291.           DELAY1   : Delay Time between CYCLE1 (Milliseconds / 4).  
  292.                      (0..65535)
  293.              
  294.           VARIATION: Frequency value is changed by this number for
  295.                      each CYCLE the note is played.  A negative number
  296.                      will be subtracted, but if FREQ reaches 0 then 
  297.                      VARIATION is added to FREQ for the remainder of the
  298.                      cycles.
  299.                      (-65535..65535)
  300.  
  301.           CYCLE2    : Number of times to repeat the first 5 parameters
  302.                       <Freq;Duration;cycles;delay;variation>
  303.                       (0..65535)
  304.  
  305.           DELAY2    : Delay Time between CYCLE2 (Milliseconds /4).
  306.                       (0..65535)
  307.      
  308.           (NOTE: 1 second = 1000 milliseconds)
  309.              
  310.      
  311.           EXAMPLE: (Telephone jingle)
  312.                    ESC[MF 800;1;2;50;-200;10;50 CTRL-N
  313.  
  314.                 ESC[MF  Trigger sequencd
  315.           Freq:    800  Note Frequency 
  316.           Dura:      1  Play Note for 1 Clock Tick (18.2 ticks per second)
  317.           Cyc1:      2  Repeat Frequency\Duration 2 times
  318.           Dly1:     50  Delay 10/4 milliseconds before repeating 
  319.           Vari:   -200  Decrease Note value by 200 each cycle 
  320.           Cyc2:     10  Repeat first 5 parameters 10 times
  321.           Dly2:     50  Delay 10/4 milliseconds before repeating
  322.                 CTRL-N  Terminate Character
  323.           
  324.  
  325.           One advantage of the SOUND CODE is the ability to place a
  326.           PAUSE in your ANSI screens without having to use a
  327.           multitude of ESC[s codes.  Just use a SOUND CODE with the
  328.           DELAY set very high to get a pause.  For example,
  329.      
  330.           ESC[MF ;;;60000
  331.      
  332.           would pause your ANSI Screen for 15 seconds (60000/4), or 
  333.           until a key is pressed when viewing it with SMILE.  Remember,
  334.           these SOUND CODES are not supported by bulletin boards...(yet)!
  335.  
  336.      
  337.           Press Any Key to exit a DURATION or DELAY action.
  338.      
  339.           SOUND CODE Musical Note Frequency Values (7 Octives):
  340.      
  341.  
  342.             C    C#   D    D#   E    F    F#   G    G#   A    A#   B
  343.        
  344.             65   69   73   78   82   87   92   98  104  110  116  123 
  345.            131  139  147  156  165  175  185  196  208  220  233  247 
  346.            262  278  294  312  330  350  370  392  416  440  466  494 
  347.            524  556  588  624  660  700  740  784  832  880  932  988 
  348.           1048 1112 1176 1248 1320 1400 1480 1568 1664 1760 1864 1976 
  349.           2096 2224 2352 2496 2640 2800 2960 3136 3328 3520 3728 3952 
  350.           4192 4448 4704 4992 5280 5600 5920 6272 6656 7040 7456 7904  
  351.  
  352.  
  353.      
  354.  
  355.          ┌──┐
  356.          │DISCLAIMER:
  357.          └──┘ 
  358.      
  359.           SMILEQ 2.0, SMILEL 1.0 and SMILESS 1.0 are provided *AS IS* 
  360.           without any warranty, expressed or implied.  All Rights are 
  361.           reserved.  The author will assume no liability for damages 
  362.           either from the direct use of this product or as a consequence
  363.           of the use of this product.
  364.      
  365.      
  366.      
  367.          ┌──┐
  368.          │COMMENTS:
  369.          └──┘ 
  370.      
  371.           SMILEQ, SMILEL and SMILESS were written with
  372.           Turbo Pascal 6.0 and TechnoJock Software Toolkits
  373.                    
  374.      
  375.           GT Power is copyright by P&M Software
  376.           ANSIPLAY is copyright by Julie Ibarra
  377.      
  378.          
  379.           SMILE QUICK 1.0, SMILE LIST 1.0, and SMILE SLIDE SHOW 1.0 
  380.           have been donated to MAKE A KID SMILE, INC. at no cost.
  381.           All proceeds are used in support of donating computers for
  382.           use by hospitalized children.  These programs are fully
  383.           functional.  Please support the shareware concept and help
  384.           use MAKE A KID SMILE.
  385.  
  386.           If you find this program useful, please consider supporting
  387.           The MAKE A KID SMILE project with whatever you can afford.
  388.           This would encourage further development of this program.  For
  389.           a donation of $20 or more you will receive the latest versions 
  390.           of SMILE Quick, SMILE List and SMILE Slide Show Viewers, and 
  391.           The SMILING KIDS ANSI ART COLLECTION.  Please specify the 
  392.           program you are ordering.  
  393.  
  394.                      Send donations to the following adress
  395.                  and make all checks payable to MAKE A KID SMILE.  
  396.                  For those outside the US we ask that you please
  397.                  send a cashier's check or money order.
  398.  
  399.  
  400.          
  401.                            MAKE A KID SMILE 
  402.                            c/o Ernest DeBakey
  403.                            The Bechtel Tower, Suite 1480
  404.                            3000 Post Oak Boulevard
  405.                            Houston, TX 77056-6582     
  406.      
  407.      
  408.           All comments and suggestions are welcomed and may be sent to:
  409.  
  410.                            Michael Arnett
  411.                            2623 Halstead 
  412.                            Spring, TX 77386
  413.  
  414.                            or 
  415.  
  416.                            GT Power Network EMAIL
  417.  
  418.                            The Gavel BBS, Houston Tx.
  419.                                NetMail  001/030
  420.                                EchoMail E10/037   
  421.  
  422.